
    <!DOCTYPE html>
    <html lang="zh-CN">
    <head>
      <meta charset="UTF-8">
      <meta name="viewport" content="width=device-width, initial-scale=1.0">
      <title>swagger - 交互式测验</title>
      <style>
        @import url('https://fonts.googleapis.com/css2?family=Noto+Sans+SC:wght@400;500;700&display=swap');
        
        body {
          font-family: 'Noto Sans SC', sans-serif;
          background-color: #f4f7f9;
          color: #333;
          display: flex;
          justify-content: center;
          align-items: center;
          min-height: 100vh;
          margin: 0;
          padding: 20px;
          box-sizing: border-box;
        }
        
        .main-wrapper {
            position: relative;
            width: 100%;
            max-width: 900px; /* Wider to accommodate buttons */
            display: flex;
            justify-content: center;
            align-items: center;
        }

        .quiz-container {
          background-color: #ffffff;
          border-radius: 16px;
          box-shadow: 0 8px 32px rgba(0, 0, 0, 0.1);
          width: 100%;
          max-width: 700px;
          overflow: hidden;
          z-index: 10;
        }

        .quiz-header {
          background-color: #4a90e2;
          color: white;
          padding: 20px 30px;
          text-align: center;
        }

        .quiz-header h1 {
          margin: 0;
          font-size: 24px;
          font-weight: 700;
        }
        
        .quiz-header p {
            margin: 5px 0 0;
            font-size: 14px;
            opacity: 0.9;
        }

        .quiz-body {
          padding: 30px;
        }

        .progress-bar {
            display: none; /* 隐藏进度条 */
            width: 100%;
            background-color: #e0e0e0;
            border-radius: 5px;
            height: 10px;
            margin-bottom: 20px;
        }

        #progress-indicator {
            height: 100%;
            width: 0%;
            background-color: #4caf50;
            border-radius: 5px;
            transition: width 0.3s ease;
        }

        #question-container {
          margin-bottom: 20px;
        }

        #question-text {
          font-size: 18px;
          font-weight: 500;
          line-height: 1.6;
          margin-bottom: 25px;
        }

        .options-list {
          list-style: none;
          padding: 0;
          margin: 0;
        }

        .option-item {
          background-color: #f8f9fa;
          border: 1px solid #dee2e6;
          border-radius: 8px;
          padding: 15px;
          margin-bottom: 12px;
          cursor: pointer;
          transition: background-color 0.2s ease, border-color 0.2s ease;
        }

        .option-item:hover {
          background-color: #e9ecef;
        }
        
        .option-item.selected {
            background-color: #d1e7fd;
            border-color: #4a90e2;
        }

        .quiz-footer {
          padding: 20px 30px;
          display: flex;
          justify-content: space-between; /* 将按钮分布在两侧 */
          align-items: center;
          min-height: 65px; /* Reserve space */
        }

        .nav-btn {
          background-color: #4a90e2;
          color: white;
          border: none;
          border-radius: 8px;
          padding: 10px 20px;
          font-size: 16px;
          font-weight: 500;
          cursor: pointer;
          transition: background-color 0.2s ease, transform 0.2s ease;
          box-shadow: 0 4px 12px rgba(0,0,0,0.15);
        }
        
        #next-btn {
            background-color: #28a745;
        }

        .nav-btn:hover {
          background-color: #357abd;
          transform: scale(1.05);
        }
        
        .nav-btn:disabled {
            background-color: #a0c3e8;
            cursor: not-allowed;
            opacity: 0.7;
        }

        #result-container {
            border-top: 1px solid #eee;
        }
        
        .result-box {
            border-radius: 8px;
            padding: 20px;
            margin-top: 20px;
        }
        
        .result-box.correct {
            background-color: #d4edda;
            border: 1px solid #c3e6cb;
            color: #155724;
        }

        .result-box.incorrect {
            background-color: #f8d7da;
            border: 1px solid #f5c6cb;
            color: #721c24;
        }
        
        .result-box h3 {
            margin-top: 0;
        }

        .explanation-text {
            margin-top: 15px;
            line-height: 1.7;
        }
        
        .source-text {
            font-style: italic;
            font-size: 14px;
            margin-top: 15px;
            color: #555;
        }

        
        .final-score-container {
            padding: 40px;
            text-align: center;
        }
        .final-score-container h2 {
            margin-top: 0;
            margin-bottom: 30px;
        }
        .score-summary {
            display: flex;
            justify-content: center;
            gap: 20px;
            margin-bottom: 40px;
            flex-wrap: wrap;
        }
        .score-card {
            background-color: #f8f9fa;
            border-radius: 12px;
            padding: 20px;
            width: 180px;
            box-shadow: 0 4px 12px rgba(0,0,0,0.05);
            border: 1px solid #e9ecef;
        }
        .score-card h3 {
            margin: 0 0 10px;
            font-size: 16px;
            font-weight: 500;
            color: #555;
        }
        .score-card p {
            margin: 0;
            font-size: 28px;
            font-weight: 700;
            color: #333;
        }
        .score-details table {
            width: 100%;
            font-size: 16px;
        }
        .score-details td {
            padding: 4px 0;
        }
        .score-details td:last-child {
            text-align: right;
            font-weight: 700;
        }
        .report-actions button {
            background-color: #fff;
            border: 1px solid #ccc;
            border-radius: 8px;
            padding: 12px 25px;
            font-size: 16px;
            cursor: pointer;
            margin: 0 10px;
            transition: background-color 0.2s ease, border-color 0.2s ease, transform 0.2s ease;
        }
        .report-actions button:hover {
            background-color: #f1f1f1;
            border-color: #bbb;
            transform: translateY(-2px);
        }
        .report-actions button.primary {
            background-color: #28a745;
            color: white;
            border-color: #28a745;
        }
        .report-actions button.primary:hover {
            background-color: #218838;
        }
        
        .hint-container {
            background-color: #e0f7fa;
            border: 1px solid #b2ebf2;
            border-radius: 8px;
            padding: 15px;
            margin-top: 20px;
            color: #006064;
            font-size: 15px;
            line-height: 1.6;
            display: none; /* 默认隐藏 */
        }
      </style>
    </head>
    <body>
      <div class="main-wrapper">
          <div class="quiz-container">
            <div class="quiz-header">
              <h1>swagger - 交互式测验</h1>
              <p>检验你对文档内容的理解程度</p>
            </div>
            <div id="quiz-content">
                <div class="quiz-body">
                    <div class="progress-bar">
                        <div id="progress-indicator"></div>
                    </div>
                    <div id="question-container">
                      <p id="question-text"></p>
                      <ul class="options-list" id="options-list"></ul>
                    </div>
                    <div id="result-container"></div>
                    <div id="hint-container" class="hint-container"></div>
                </div>
                <div class="quiz-footer" id="quiz-footer">
                  <button id="prev-btn" class="nav-btn">上一题</button>
                  <button id="hint-btn" class="nav-btn" style="background-color: #ffc107; color: #333; box-shadow: 0 4px 12px rgba(255,193,7,0.3);">提示</button>
                  <button id="next-btn" class="nav-btn">下一题</button>
                </div>
            </div>
          </div>
      </div>

      <script>
        const quizData = [
  {
    "question": "根据CAP理论，在分布式系统设计中，为什么通常必须在一致性（C）和可用性（A）之间进行权衡？",
    "options": [
      "因为持久性（Durability）比一致性和可用性更重要。",
      "因为分区容错性（P）在分布式网络环境中是不可避免的，系统必须容忍网络分区，因此只能在C和A中选择一个。",
      "因为同时实现高一致性和高可用性会导致系统性能（Performance）急剧下降。",
      "因为分区容错性（P）是可以根据业务需求选择性放弃的。"
    ],
    "correctAnswerIndex": 1,
    "explanation": "CAP理论的核心在于，任何分布式系统最多只能同时满足一致性（C）、可用性（A）和分区容错性（P）中的两项。在现代分布式系统中，网络故障或延迟导致的分区是常态而非例外，因此分区容错性（P）是必须保证的基础。这就迫使设计者在剩下的一致性（C）和可用性（A）之间做出选择和权衡。",
    "source": "文档中「CAP 定律」部分",
    "hint": "文档中提到：“对于一个分布式系统，分区容错性（P）是一个必须满足的基本要求...因此架构师的精力应该集中在如何在一致性和可用性之间寻求平衡。”"
  },
  {
    "question": "在两阶段提交（2PC）协议中，最主要的缺点是什么，这可能导致系统出现严重问题？",
    "options": [
      "协议实现过于复杂，需要引入额外的中间件。",
      "网络通信开销巨大，因为需要多次往返通信。",
      "同步阻塞问题，即所有参与者在等待协调者决策期间会长期持有资源锁，以及协调者的单点故障风险。",
      "它无法保证数据的强一致性，只是一种最终一致性方案。"
    ],
    "correctAnswerIndex": 2,
    "explanation": "2PC最突出的问题是其同步阻塞机制。在第一阶段结束后，所有参与者都会锁定资源并等待协调者的最终指令。如果协调者宕机或网络中断，这些资源将一直被锁定，导致整个系统的可用性下降。此外，协调者本身是一个单点，它的故障会直接影响整个事务的完成。",
    "source": "文档中「两阶段提交 (2PC)」部分的「缺点」小节",
    "hint": "思考一下，如果协调者在决定全局提交后，但在通知所有参与者之前宕机了，会发生什么？"
  },
  {
    "question": "与ACID模型强调强一致性不同，BASE理论的核心思想是什么？",
    "options": [
      "优先保证系统的可用性（Basically Available），并接受系统状态在一段时间内不一致（Soft state），但最终会达到一致状态（Eventually consistent）。",
      "它是一种比ACID更严格的一致性模型，要求所有节点在任何时刻数据都必须完全一致。",
      "它完全放弃了事务的概念，依赖于手动数据校对。",
      "它强调通过牺牲可用性来换取绝对的数据一致性和隔离性。"
    ],
    "correctAnswerIndex": 0,
    "explanation": "BASE理论是面向高可用、可扩展的分布式系统的设计思想，它是对CAP理论中C和A权衡的结果。它包含三个核心元素：基本可用（BA），软状态（S），和最终一致性（E）。它容忍数据在一定时间内不一致，但承诺数据最终会同步，以此来换取系统在出现故障时仍能对外提供服务的能力。",
    "source": "文档中「BASE 理论」部分",
    "hint": "BASE是 Basically Available, Soft state, Eventually consistent 三个短语的缩写，这三个短语共同构成了它的核心思想。"
  },
  {
    "question": "Saga模式是如何通过一系列本地事务来保证最终数据一致性的？",
    "options": [
      "通过一个全局的事务协调器，在所有本地事务执行前锁定资源。",
      "如果某个本地事务失败，Saga会执行一系列对应的“补偿事务”来撤销之前已成功提交的本地事务。",
      "Saga要求所有本地事务必须在同一个数据库实例中执行，以利用其ACID特性。",
      "它依赖于三阶段提交协议（3PC）来确保每个本地事务的原子性。"
    ],
    "correctAnswerIndex": 1,
    "explanation": "Saga模式的核心机制是补偿。它将一个长事务拆分为多个本地事务，每个本地事务都有一个对应的补偿操作。当链条中的某个本地事务失败时，系统会按相反的顺序调用前面已成功事务的补偿操作，从而回滚整个业务流程，达到最终一致性的状态。这种方式避免了长期锁定资源，提高了系统的可用性。",
    "source": "文档中「Saga 模式」部分",
    "hint": "文档中描述了Saga模式的恢复逻辑：“如果Saga中的任何一个本地事务失败，Saga会执行一系列的补偿事务，以撤销之前已经成功的本地事务产生的影响。”"
  },
  {
    "question": "与其他分布式事务方案相比，TCC（Try-Confirm-Cancel）模型的一个显著特点是什么？",
    "options": [
      "它对业务代码完全无侵入，开发者无需修改现有逻辑。",
      "它是一种异步执行的模型，不依赖于中心化的协调。",
      "它严重依赖消息队列的可靠性来传递事务状态。",
      "它对业务逻辑具有侵入性，需要开发者将一个业务操作显式地分解为Try、Confirm、Cancel三个阶段的接口。"
    ],
    "correctAnswerIndex": 3,
    "explanation": "TCC模型最显著的特点是它是一种补偿型、应用层的事务模型，对业务代码有较强的侵入性。开发者不能像使用本地事务那样简单地开启和提交，而是必须为每个服务接口提供Try、Confirm和Cancel三种操作的实现。这虽然增加了开发成本，但也提供了更高的灵活性和控制力。",
    "source": "文档中「TCC (Try-Confirm-Cancel)」部分",
    "hint": "该方案要求业务逻辑的实现方式需要作出相应调整，它将一个业务操作分解为三个部分。"
  },
  {
    "question": "本地消息表（Outbox Pattern）方案主要解决了分布式系统中的哪个核心问题？",
    "options": [
      "解决了跨多个数据库的强一致性事务问题。",
      "确保了在执行本地数据库事务和发送消息这两个操作之间的原子性。",
      "优化了2PC协议中的同步阻塞问题。",
      "降低了分布式系统中服务间通信的网络延迟。"
    ],
    "correctAnswerIndex": 1,
    "explanation": "本地消息表（Outbox Pattern）的核心目标是解决一个非常常见的分布式场景：既要完成数据库操作，又要发送一个消息通知下游服务，如何保证这两个操作“要么都成功，要么都失败”？通过将“待发送的消息”和业务数据变更放在同一个本地事务中写入数据库，它巧妙地将分布式事务问题转化为本地事务问题，从而确保了操作的原子性和数据的最终一致性。",
    "source": "文档中「本地消息表（可靠消息最终一致性）」部分",
    "hint": "思考一下，当你的代码需要执行'更新数据库'和'发送消息'这两个操作时，如何确保它们作为一个整体成功或失败？"
  },
  {
    "question": "三阶段提交（3PC）协议相对于两阶段提交（2PC）最主要的改进是什么？",
    "options": [
      "它完全解决了协调者的单点故障问题。",
      "它通过引入一个“PreCommit”阶段和超时机制，减少了参与者的同步阻塞时间。",
      "它将协议从同步模型改为了完全的异步模型，大幅提升了性能。",
      "它极大地减少了协议所需的网络通信次数。"
    ],
    "correctAnswerIndex": 1,
    "explanation": "3PC的设计初衷是为了解决2PC的主要痛点——同步阻塞。它在2PC的“准备阶段”和“提交阶段”之间增加了一个“PreCommit”阶段。这个阶段起到了缓冲作用，并引入了超时机制。如果参与者在等待协调者指令时超时，它可以自行决定提交或中断，从而避免了资源的无限期锁定，降低了阻塞风险。",
    "source": "文档中「三阶段提交 (3PC)」部分",
    "hint": "3PC在2PC的基础上增加了一个阶段，这个额外的阶段为处理协调者故障和网络问题提供了更多的可能性。"
  }
];
        console.log("Quiz Data:", JSON.parse(JSON.stringify(quizData))); // 添加这行用于调试，以可展开的JSON格式输出
        
        let currentQuestionIndex = 0;
        let score = 0;
        // 存储每个问题的回答状态
        const userAnswers = new Array(quizData.length).fill(null); 

        const questionTextEl = document.getElementById('question-text');
        const optionsListEl = document.getElementById('options-list');
        const resultContainerEl = document.getElementById('result-container');
        const quizContentEl = document.getElementById('quiz-content');
        const progressIndicatorEl = document.getElementById('progress-indicator');
        const prevBtn = document.getElementById('prev-btn');
        const nextBtn = document.getElementById('next-btn');
        const hintBtn = document.getElementById('hint-btn');
        const hintContainerEl = document.getElementById('hint-container');

        function loadQuestion() {
          resultContainerEl.innerHTML = '';
          optionsListEl.innerHTML = '';
          hintContainerEl.style.display = 'none'; // 隐藏提示
          
          if (currentQuestionIndex >= quizData.length) {
            showFinalScore();
            return;
          }

          updateProgress();

          const currentQuestion = quizData[currentQuestionIndex];
          questionTextEl.textContent = `(${currentQuestionIndex + 1}/${quizData.length}) ${currentQuestion.question}`;
          
          currentQuestion.options.forEach((optionText, index) => {
            const li = document.createElement('li');
            li.className = 'option-item';
            li.textContent = optionText;
            li.dataset.index = index; // Store index in a data attribute
            // 如果这道题已经回答过，恢复状态
            if (userAnswers[currentQuestionIndex] !== null) {
                if (index === userAnswers[currentQuestionIndex]) {
                    li.classList.add('selected');
                }
            }
            optionsListEl.appendChild(li);
          });

          // 如果已经回答过，直接显示结果
          if (userAnswers[currentQuestionIndex] !== null) {
              const isCorrect = userAnswers[currentQuestionIndex] === currentQuestion.correctAnswerIndex;
              showResult(isCorrect, currentQuestion);
          }
          
          updateNavigationButtons();
          updateProgress();
        }

        function selectOption(optionIndex) {
            userAnswers[currentQuestionIndex] = optionIndex;
            const currentQuestion = quizData[currentQuestionIndex];
            const isCorrect = optionIndex === currentQuestion.correctAnswerIndex;

            // 重新计算分数
            score = userAnswers.reduce((acc, answer, index) => {
                return answer === quizData[index].correctAnswerIndex ? acc + 1 : acc;
            }, 0);

            showResult(isCorrect, currentQuestion);
            updateNavigationButtons();
        }
        
        function updateProgress() {
            const answeredQuestions = userAnswers.filter(answer => answer !== null).length;
            const progressPercentage = (answeredQuestions / quizData.length) * 100;
            progressIndicatorEl.style.width = `${progressPercentage}%`;
        }
        
        function updateNavigationButtons() {
            prevBtn.style.display = 'block';
            nextBtn.style.display = 'block';
            hintBtn.style.display = 'block'; // 显示提示按钮

            prevBtn.disabled = currentQuestionIndex === 0;
            nextBtn.disabled = false; // 最后一题时，下一题按钮不禁用，而是用于显示报告
            nextBtn.textContent = (currentQuestionIndex === quizData.length - 1) ? '查看报告' : '下一题';
            
            // 如果当前问题没有提示，则禁用提示按钮并隐藏提示内容
            if (!quizData[currentQuestionIndex].hint) {
                hintBtn.disabled = true;
                hintContainerEl.style.display = 'none';
                hintContainerEl.textContent = ''; // 清除旧的提示内容
            } else {
                hintBtn.disabled = false;
            }
        }

        function showResult(isCorrect, questionData) {
            resultContainerEl.innerHTML = ''; // 清空之前的结果
            const resultBox = document.createElement('div');
            resultBox.className = `result-box ${isCorrect ? 'correct' : 'incorrect'}`;
            
            let html = `<h3>${isCorrect ? '回答正确！' : '回答错误'}</h3>`;
            if (!isCorrect) {
                html += `<p><strong>正确答案是：</strong> ${questionData.options[questionData.correctAnswerIndex]}</p>`;
            }
            html += `<div class="explanation-text">${questionData.explanation}</div>`;
            html += `<div class="source-text">来源: ${questionData.source}</div>`;
            
            resultBox.innerHTML = html;
            resultContainerEl.appendChild(resultBox);

            // 禁用所有选项的点击事件，并高亮正确/错误答案
            Array.from(optionsListEl.children).forEach((child, index) => {
                child.style.pointerEvents = 'none';
                // 高亮正确答案
                if (index === questionData.correctAnswerIndex) {
                    child.classList.add('correct'); // 需要添加CSS样式
                    child.style.backgroundColor = '#d4edda';
                    child.style.borderColor = '#c3e6cb';
                }
                // 如果选错了，高亮错误选项
                if (!isCorrect && index === userAnswers[currentQuestionIndex]) {
                    child.classList.add('incorrect'); // 需要添加CSS样式
                    child.style.backgroundColor = '#f8d7da';
                    child.style.borderColor = '#f5c6cb';
                }
            });
        }

        function goToNextQuestion() {
            if (currentQuestionIndex < quizData.length - 1) {
                currentQuestionIndex++;
                loadQuestion();
            } else {
                showFinalScore();
            }
        }

        function goToPreviousQuestion() {
            if (currentQuestionIndex > 0) {
                currentQuestionIndex--;
                loadQuestion();
            }
        }
        
        function showHint() {
            const currentQuestion = quizData[currentQuestionIndex];
            if (currentQuestion.hint) {
                hintContainerEl.textContent = currentQuestion.hint;
                hintContainerEl.style.display = 'block';
            } else {
                hintContainerEl.style.display = 'none';
            }
        }

        function showFinalScore() {
            document.querySelector('.quiz-body').style.display = 'none';
            document.getElementById('quiz-footer').style.display = 'none';

            const correctCount = score;
            const totalQuestions = quizData.length;
            const answeredCount = userAnswers.filter(a => a !== null).length;
            const wrongCount = answeredCount - correctCount;
            const skippedCount = totalQuestions - answeredCount;
            const accuracy = totalQuestions > 0 ? Math.round((correctCount / totalQuestions) * 100) : 0;
            const errorRate = totalQuestions > 0 ? Math.round((wrongCount / totalQuestions) * 100) : 0;

            const finalScoreHtml =
                '<div class="final-score-container">' +
                '<h2>答题报告</h2>' +
                '<div class="score-summary">' +
                '<div class="score-card">' +
                '<h3>得分</h3>' +
                '<p>' + correctCount + ' / ' + totalQuestions + '</p>' +
                '</div>' +
                '<div class="score-card">' +
                '<h3>正确率</h3>' +
                '<p>' + accuracy + '%</p>' +
                '</div>' +
                '<div class="score-card">' +
                '<h3>错误率</h3>' +
                '<p>' + errorRate + '%</p>' +
                '</div>' +
                '<div class="score-card score-details">' +
                '<table>' +
                '<tr><td>正确</td><td>' + correctCount + '</td></tr>' +
                '<tr><td>错误</td><td>' + wrongCount + '</td></tr>' +
                '<tr><td>未答</td><td>' + skippedCount + '</td></tr>' +
                '</table>' +
                '</div>' +
                '</div>' +
                '<div class="report-actions">' +
                '<button id="review-btn">回顾测验</button>' +
                '<button class="primary" onclick="location.reload()">再试一次</button>' +
                '</div>' +
                '</div>';

            let reportEl = document.querySelector('.final-score-container');
            if (reportEl) {
                reportEl.remove();
            }
            quizContentEl.insertAdjacentHTML('beforeend', finalScoreHtml);
            document.getElementById('review-btn').addEventListener('click', reviewQuiz);
        }

        function reviewQuiz() {
            const reportEl = document.querySelector('.final-score-container');
            if (reportEl) {
                reportEl.remove();
            }

            document.querySelector('.quiz-body').style.display = 'block';
            document.getElementById('quiz-footer').style.display = 'flex';
            
            currentQuestionIndex = 0;
            loadQuestion();
            updateNavigationButtons(); // Ensure nav buttons are correctly displayed
        }

        // Event Delegation for options
        optionsListEl.addEventListener('click', (event) => {
            if (event.target && event.target.matches('li.option-item')) {
                // Check if the question has already been answered
                if (userAnswers[currentQuestionIndex] === null) {
                    const selectedIndex = parseInt(event.target.dataset.index, 10);
                    selectOption(selectedIndex);
                }
            }
        });

        prevBtn.addEventListener('click', goToPreviousQuestion);
        nextBtn.addEventListener('click', goToNextQuestion);
        hintBtn.addEventListener('click', showHint);
        
        // 初始加载
        loadQuestion();
      </script>
    </body>
    </html>
  